home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / gfx / misc / graphtal1293.readme < prev    next >
Encoding:
Text File  |  1993-12-14  |  4.8 KB  |  129 lines
  1. Short: Trees,Plants...from grammars(rayshade)
  2.  
  3. README.AMIGA  (2nd Version 12.93)
  4. ============= 
  5.  
  6. - To compile Graphtal on the Amiga you need GCC-233, the os-includes 
  7.   and a lot of memory. (compilation without optimizer: about 6MB)
  8.   Don't forget to set a large stack size (256000 is fine) !
  9.   Because AmigaDOS isn't case sensitive you must edit string.h 
  10.   (for more information on this read the header of string.h)
  11.   (NEW) Do also read the file IMPORTANT.README.AMIGA 
  12.  
  13. - Graphtal has a device for Rayshade output.
  14.  
  15. - I have include some tools to convert PPM output to IFF24 in bin
  16.   (to convert PPM output to IFF get the the PBM plus package)
  17.  
  18. - Note: some examples for Graphtal need a lot of memory (over 10MB) !
  19.  
  20. - Note: Graphtal needs the cpp to process the inputfile.
  21.   (NEW) cpp and sh are now included in the directory Unix
  22.  
  23. - GCC-233 and Rayshade are available by anonymous FTP in ftp.luth.se 
  24.   or any other Aminet site
  25.  
  26. - (NEW) Note: setting the environment variable COLORFILE now works
  27.   (see changes in file color.C)
  28.  
  29. - (NEW) examples how to use graphtal can be found in the file EXAMPLE.SCRIPT
  30.  
  31.  
  32. Lucas Ammon (lammon@iamexwi.unibe.ch)
  33.  
  34.  
  35. DESCRIPTION
  36.      graphtal is a tool for manipulating  spT0L-systems  (context
  37.      free, table oriented L-systems with stochastic productions).
  38.      graphtal reads a file containing an L-system description and
  39.      starts  the interpretation. In addition, graphtal is able to
  40.      interpret the result graphically, producing different  kinds
  41.      of output.
  42.  
  43.      The main reference for the program is the book  The  Virtual
  44.      Laboratory:  The Algorithmic Beauty of Plants by P. Prusink-
  45.      iewicz and A. Lindenmayer. The language used in graphtal  is
  46.      different  from  the  one  in the book and will be described
  47.      completely in this document.
  48.  
  49.  
  50. DEVICE DRIVERS
  51.   EXAMPLE DEVICE
  52.      The example driver produces a ASCII dump of  the  primitives
  53.      generated.  It shows the easiest way to implement a driver.
  54.  
  55.   BBOX DEVICE
  56.      The bbox driver computes the bounding box and gives  a  hint
  57.      for  the viewing parameters of the objects defined by the L-
  58.      system description.  This is useful  for  the  flat  device,
  59.      which does no automatic view computations.
  60.  
  61.   LINE DEVICE (X11,AMIGA)
  62.      This driver generates a simple line drawing  of  the  object
  63.      defined  by  the  L-system.  Line  width,  color,  textures,
  64.      spheres, macros and library object are not supported by this
  65.      driver.  Viewing parameters are automatically set, when none
  66.      are provided by the user.
  67.  
  68.   WIRE DEVICE (X11,AMIGA)
  69.      The wire device driver draws a more realistic image  of  the
  70.      object  than line device. Not supported are colors, textures
  71.      and  library  objects.   Viewing  parameters  are  also  set
  72.      automatically, when none are provided.
  73.  
  74.   FLAT DEVICE
  75.      The flat device works with a z-buffer  algorithm,  which  is
  76.      able  to shade convex and concave polygons. Shading calcula-
  77.      tions are done with regard to the light  source  located  at
  78.      the  eyepoint.  The  driver does not depend on the number of
  79.      polygons, therefore even very large scenes  can  be  visual-
  80.      ized.  As a drawback of this feature, the viewing parameters
  81.      have to be provided by the user (use BBOX DEVICE  to  calcu-
  82.      late  them).  Textures and library objects are not supported
  83.      by this driver.  The output of the rendering process  is  an
  84.      image in ppm format (portable pixmap). 
  85.  
  86.  
  87.   RAYSHADE DEVICE
  88.      The rayshade device is the most complete of all the drivers.
  89.      It  generates  output for the raytracer rayshade. The driver
  90.      produces at least two output files:
  91.  
  92.      graphtal -d rayshade anExample.lsys
  93.      generates the files default.ray and default.ray.def
  94.  
  95.      graphtal -d rayshade -O anExample.ray
  96.      generates the files anExample.ray and anExample.ray.def.
  97.  
  98.      The file name.ray contains the  options  for  the  rendering
  99.      process  and  in  the name.ray.def file the geometric primi-
  100.      tives are stored.  For each macro definition,  the  rayshade
  101.      driver    produces    it's    own   file   with   the   name
  102.      macrName.ray.def. If library objects are used, a  file  with
  103.      the  name  libraryName.ray.lib  must be provided by the user
  104.      for each object.
  105.  
  106.  
  107. AUTHOR
  108.      Christoph Streit (streit@iam.unibe.ch)
  109.  
  110. AMIGA PORT
  111.      Lucas Ammon (lammon@iamexwi.unibe.ch)
  112.  
  113.  
  114. COPYRIGHT NOTICE
  115.      Copyright (C) 1992 Christoph Streit
  116.  
  117.      All rights reserved.
  118.  
  119.      This software may be freely copied, modified, and  redistri-
  120.      buted  provided  that  this copyright notice is preserved on
  121.      all copies.
  122.  
  123.      You may not distribute this software, in whole or  in  part,
  124.      as  part  of any commercial product without the express con-
  125.      sent of the authors.
  126.  
  127.      There is no warranty or other guarantee of fitness  of  this
  128.      software for any purpose.  It is provided solely "as is".
  129.